Show Connected Hub

Request

Returns data about single Connected Hub.

Security

ApiKeyAuth

Path

subdomainstringrequired

Unique subdomain of Primary Hub for requested Connected Hub.

connected_subdomainstringrequired

Unique subdomain of Connected Hub.

Query

api_versionstring

Api version

Value:"V3-R1"

curl -i -X GET \
  'https://subdomain-of-your-account.app.statushub.io/api/v3/hubs/{subdomain}/connected_hubs/{connected_subdomain}?api_version=V3-R1' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json

idinteger, >= 1

Example:12

namestring

subdomainstring[a-z0-9][a-z0-9_-]*[a-z0-9]

Hub subdomain.
Hub subdomain serves two purposes:

In various places it is being used as Hub unique identifier in place of less descriptive numerical ID,
Forms Hub URL which without custom domain in place has a form of https://{{subdomain}}.statushub.io.

Example:"company-status"

custom_domainstring or null

Alternative domain name under which the Hub can be accessed.
Currently this field can be set only through a support ticket because of the additional steps required like setting up the TLS certificate.

Example:"status.example-company.com"

parent_idinteger or null, [ 1 .. 9999 ]

Present only for Connected Hubs. For Primary Hubs this field is absent or has null.
Contains the numerical ID of Primary Hub for current Connected Hub.

product_urlstring or null

URL of the product or service for which current Hub is set-up for. Alternatively called "Monitored site URL" in Hub Main Settings in StatusHub Control Panel.

Used as a link target for Hub name or Logo in Hub Page top-bar.

Example:"https://www.example-company.com/service"

typestring

Hub type:

Primary Hub Independent Hub without any overlap with other Hubs data. Associated with billing subscription, Can have Connected Hubs if its subscription allows it.
Connected Hub - Hub that shares following aspects with its Primary Hub:
- Subset of Groups,
- Subset of Services,
- Events affecting the shared Services,
- Subscription.
All other data like Subscriptions and settings is independent.

Enum:"primary""connected"

Example:"primary"

created_atstring, (date-time)

Timestamp of record creation.
ISO8601 formatted time (UTC).

Example:"2020-09-01T08:29:00Z"

updated_atstring, (date-time)

Timestamp of last modification of record.
ISO8601 formatted time (UTC).

Example:"2020-09-01T08:29:00Z"

Response

{
  "id": 12,
  "name": "string",
  "subdomain": "company-status",
  "custom_domain": "status.example-company.com",
  "parent_id": 1,
  "product_url": "https://www.example-company.com/service",
  "type": "primary",
  "created_at": "2020-09-01T08:29:00Z",
  "updated_at": "2020-09-01T08:29:00Z"
}